home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / interpcb.arc / IP.DOC < prev    next >
Text File  |  1990-04-20  |  11KB  |  264 lines
  1.  
  2.  
  3.                               InterPCB v0.60ß
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                   Copyright 1990 InterZone Software, Inc.
  11.                             All Rights Reserved
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                 Written by
  19.                     Peter Stewart and Michele Hamilton
  20.  
  21.  
  22.  
  23.  
  24.                                 FILES LIST
  25.                                 ==========
  26.  
  27.           IP.EXE         Program
  28.           IP.BAT         Sample batch file
  29.           IP.DOC         This documentation
  30.           WIPE.EXE       Utility to delete all files with the same extension.
  31.           INTERZ.REG     Registration Form
  32.  
  33.  
  34.                                INTRODUCTION
  35.                                ============
  36.  
  37.      There aren't too many  good programs to convert Fido's *.msg files to
  38.      a PCBoard  message base  and visa  versa.  Of the  two  currently out
  39.      there,  they  either  take  up too much  space, are  too slow, or are
  40.      liable to hang up your system (at least in our experience).
  41.  
  42.      Which is  why we wrote  InterPCB. It is a  fast,  simple, easy to use
  43.      commandline program that will take each fido *.msg and import it into
  44.      a PCBoard message base, updating  the index and even reformatting. It
  45.      ain't pretty, but  it does what  it's supposed  to do time after time
  46.      after time. Which is, after all, what a program should always be.
  47.  
  48.  
  49.                     NOTICES, WARRANTIES AND GUARANTEE
  50.                     =================================
  51.  
  52.      This  program  has  no warranty or  guarantee  other than  to take up
  53.      space on your hard drive.  This  program  is Shareware  and should be
  54.      considered user supported software.
  55.  
  56.      This  program  MAY  NOT be commercially  reproduced or sold by anyone.
  57.      This  includes  a part of a software  library  in which  the user pays
  58.      for  the cost of the  disk.  The author  reserves  all  rights to this
  59.      program.
  60.  
  61.      This program is distributed as SHAREWARE. This means that, if you like
  62.      the program and  continue to  use it  for more  than 2 weeks, you must
  63.      register it.  Registration  will entitle  you to  full support through
  64.      FidoNet or BBSNet Netmail or the Support boards listed below.
  65.  
  66.      Additionally,  you will  be allowed  to download  future beta versions
  67.      of InterPCB.  To be  listed as  a future  beta tester,  call  SunShine
  68.      PCBoard and fill out Questionnaire #3. Future versions will be Netmail
  69.      capable with Door support for locating net/node numbers, user account-
  70.      ing, etc.
  71.  
  72.      To register  this program,  mail your  check or money order for $20.00,
  73.      together with the registration form, to:
  74.  
  75.                       InterZone Software, Inc.
  76.                       161 Madeira Avenue, Suite 57
  77.                       Coral Gables, Florida 33134
  78.  
  79.  
  80.                               ABOUT INTERPCB
  81.                               ==============
  82.  
  83.      InterPCB is  fairly straight forward.  To get a list of options or help
  84.      simply  type  "IP"  with no  arguments.  InterPCB  does not  require  a
  85.      configuration  file and  is, perhaps, easiest run as an event through a
  86.      batch file.
  87.  
  88.      After the import/export stage is finished, it  is not necessary to pack
  89.      the message bases.
  90.  
  91.      The order  in which  the directory,  pathname and  other parameters are
  92.      listed is optional.
  93.  
  94.      Should a *.msg  that has  been exported from your message base not have
  95.      been deleted from the directory  after being processed by your echomail
  96.      handler, InterPCB  will NOT  re-import  that message when next it scans
  97.      that directory for import.
  98.  
  99.      CAUTION:
  100.      If you are running ConfMail or an echomail processor other than TosScan,
  101.      InterPCB will  have no  way of knowing  whether or  not the message has
  102.      been sent  since, as far  as we know, TosScan is the only program which
  103.      toggles a 'sent' bit.  Make sure that you either do NOT use an external
  104.      message editor  or that you process your export of mail BEFORE attempt-
  105.      ing to  use InterPCB  to import  messages. If you don't take these pre-
  106.      cautions this  could cause the messages to be imported into PCBoard and
  107.      deleted from the Fido directory without being sent.
  108.  
  109.      InterPCB  kills all  *.msg  files  after they  have been  imported to  a
  110.      message base.  However, it also  reads and/or toggles the following bits
  111.      in any *.msg file to be imported or exported from a PCBoard message base
  112.      in  order to  determine if  the message  should be  deleted or not.  You
  113.      obviously don't want a message  deleted if it has not been processed for
  114.      echomail handling yet.
  115.  
  116.  
  117.      -local         IP will set the local  bit "on" automatically for all
  118.                     messages  exported from  a PCBoard message base. This
  119.                     will allow TosScan to know that this message is local
  120.                     to the system and needs to be exported for mailing.
  121.  
  122.      -transit       IP will toggle the transit message "on" automatically
  123.                     for all messages exported from or to a PCBoard message
  124.                     base. This allows IP to recognize that it has already
  125.                     imported/exported this message and to ignore it if it
  126.                     sees it again. If a message was written by an external
  127.                     editing program such as InterMail's or FrontDoor's
  128.                     editor or Xpress, but not yet sent out, after importing
  129.                     it to PCBoard IP will set the 'transit' bit on, so it
  130.                     knows that it shouldn't re-import the message.  DO NOT
  131.                     use an external editor if you are using an echomail
  132.                     processor that doesn't use the 'Sent' bit!
  133.  
  134.      -sent          IP looks for the 'sent' bit and if not found, will import
  135.                     the message to your message base but will leave it in
  136.                     your directory for echomail handling.
  137.  
  138.  
  139.                             HOW TO USE InterPCB
  140.                             ===================
  141.  
  142.         The command syntax for InterPCB is as follows:
  143.  
  144.  
  145.      IP /options /F:directory /P:pathname [/MAX:nnn] [/S]
  146.  
  147.  
  148.      /inst          Use to install a pathname for the log file.
  149.  
  150.      /i             Tells InterPCB to import *.msg files to a PCBoard message
  151.                     base.
  152.  
  153.      /e             Tells InterPCB to export mail from a PCBoard message base
  154.                     to *.msg file.
  155.  
  156.      /f:directory   where *.msg files can be found.
  157.  
  158.      /p:pathname    Path and file name of PCBoard message base.
  159.  
  160.      /max:nnn       Optional. Where 'nnn' is the maximum number of lines
  161.                     InterPCB should process on importing a message to a PCB
  162.                     message base. Default is 99 lines as currently supported
  163.                     by PCB 14.2 and below. However, in the new PCBoard 14.5,
  164.                     you will have an option to increase your message base
  165.                     lines to 200. This option allows you to reset InterPCB's
  166.                     maximum number of lines to import.
  167.  
  168.      /s             Optional. By default, InterPCB will truncate all messages
  169.                     over the 99 lines or the maximum number of lines as set by
  170.                     the /MAX:nnn parameter. Using the /S parameter will tell
  171.                     InterPCB to split a long fido message, that would
  172.                     otherwise be truncated, into two or more messages in the
  173.                     PCBoard message bases.
  174.  
  175.      /a             To avoid having to scan all messages each time InterPCB
  176.                     processes an export it will, by default, make and use a
  177.                     zero byte file that serves to tell it the last message
  178.                     number. Use the /A parameter to ignore this and process
  179.                     ALL messages in a base.
  180.  
  181.      /k             Optional. Use if you wish to keep seen-by lines. The
  182.                     default is that all seen-by lines are stripped from
  183.                     the messages.
  184.  
  185.  
  186.                                 ERRORLEVELS
  187.                                 ===========
  188.  
  189.           0    Success (no errors)
  190.           1    No messages to import
  191.           2    Fatal error (terminate)
  192.           3    Insufficient space on disk (terminate)
  193.           4    Invalid parameters
  194.           5    PCBoard message base locked (terminate)
  195.           6    Insufficient space in PCB index (increase block size)
  196.          10    User break (Ctrl-C or Ctrl-Break)
  197.  
  198.      These errorlevels may be picked up and used in a batch file to take
  199.      appropriate action. See sample batch file enclosed.
  200.  
  201.  
  202.  
  203.                                 Definitions
  204.                                 -----------
  205.  
  206.      Directory:     A DOS directory name, e.g. C:\PCB
  207.  
  208.      Pathname:      A complete filename including the path,
  209.                     e.g. E:\FD\PCBNET\PCBNET
  210.  
  211.  
  212.                                    WIPE
  213.                                    ====
  214.  
  215.      Wipe is similar to PCMag's sweep.com in that it will delete all files
  216.      on a drive.  The syntax is:
  217.  
  218.      WIPE [drive:][path][.ext] [/b] [/e]
  219.  
  220.      All parameters are optional.  The default is for Wipe to delete all
  221.      files with the extension BAK on the current drive.
  222.  
  223.      If you specify a path, WIPE will only search downwards in the directory
  224.      tree from the specified path.
  225.  
  226.      The /b parameter (for batch mode) is necessary to operate WIPE from a
  227.      batch file.  The extensions .exe, .com, .sys, .bat, .ovr, and .ovl are
  228.      illegal for batch mode operation.
  229.  
  230.      The /e parameter is only necessary if you are in the habit of using
  231.      directory names with extensions, e.g. D:\PCB.NET\MSG.FIL\  (Very few
  232.      people do...)
  233.  
  234.  
  235.                                   CREDITS
  236.                                   =======
  237.  
  238.      All InterZone products are trademarks or registered trademarks of
  239.      InterZone Software, Inc.
  240.  
  241.  
  242.      InterMail 2.00 (c) 1990 InterZone Software, Inc., is a mailer program
  243.      sold by InterZone Software, Inc.
  244.  
  245.      TosScan 1.0 was written by Joaquim Homrighausen
  246.  
  247.      FrontDoor 1.99c (c) 1990 Joaquim Homrighausen  Written by Joaquim
  248.      Homrighausen and Peter Stewart.
  249.  
  250.      PCBoard is a registered trademark of Clark Development Company and CDC
  251.      does not support this program.
  252.  
  253.      Other brand and product names are trademarks or registered trademarks
  254.      of their respective holders.
  255.  
  256.  
  257.      Support:  BBS: InterZone Software (305)596-2904 <HST>
  258.                FidoNet Node 1:135/21 <HST>
  259.  
  260.                BBS: SunShine PCBoard (305)432-2223 <HST>
  261.                FidoNet Node 1:369/21 <HST>
  262.                BBSNet Node 86:3050/6 <HST>
  263.  
  264.